Bernie ][ The Rescue 2.6
welcome

                                      ÒOnly Emulation
                                       Can Get Past
                                       The Original.Ó



please see end of document for License Agreement and contact information



Welcome To Superior Emulation!

Thank you for downloading Bernie ][ The Rescue 2.6, the premier Apple IIgs¨ emulation software for Power Macintosh¨ computers!

The software you have downloaded is shareware. There are certain limitations that will be removed as soon as you decide to register your copy. Please see the "License & Registration Info" text file for detailed information on limitations in the unregistered software.

We are now including the entire manual so upon downloading the distribution you have everything in place. The manual is made up of HTML files that you can view offline with your favorite browser. The manual is stored in the "Documentation" directory. To view it, open the file I am the manual.html with your web browser.

If you are new to Bernie and are unsure what you need in order to get started with Apple IIgs emulation, you might want to consider ordering the pretty unique Bernie Starter Kit CD-ROM from Shareware Solutions II. It includes about everything you want to have (except for the ROM dump) and has been specifically made for people who tend to avoid hassle. The CD is priced at only US$25 and comes with Bernie, the HTML documentation, utilities, system software, applications and more. The CD-ROM is available from F.E.Systems' online shopping page.

We would like to take the opportunity to thank everyone who helped us with the Bernie project. Many technical problems could only be resolved with the ongoing support of Richard Bennett and Ewen Wannop. That Bernie became the successful product it is today was only possible with the help of Ryan Suenaga, Joe Kohn, Max Jones, Tony Diaz and every single Bernie user who registered the software. 

Bernie is the product of more than three years of hard labour. It's been a lot of fun bringing Apple IIgs emulation forward, and we hope you will enjoy working with Bernie. 



Changes

Version 2.6 has arrived! The latest rendition of our snob emulator got a 1000 dogmiles service. This release packs a couple of nifty new features, and we've worked out a number of quirks for added runtime pleasure. Bernie Total Integration's file support is now complete and fully integrated into the Bernie user interface. Plus, we've got a note from repeated-stress injury doctors to do something about the PR#3 CATALOG,TBIN. So we've thrown in an extremely cool and very fast ProDOS catalog utility for insanely simple catalog browsing. And when you found the application you lost years ago, make an alias on the Mac desktop and do that single double-click that takes you from zero to your favorite GS/OS application.


What's New In Version 2.6

¥ CataDogª ProDOS browser: the files on that disk image got names. See them.
¥ Cross-Platform Aliases: it is now possible to make an alias of a GS/OS file on the Mac
Êdesktop.
¥ You can now specify a download folder for Total Integration IIgs->Mac copies in the
ÊBernie preferences window (Storage panel).
¥ The Total Integration group in the Storage preferences panel also lets you choose between
Êoverwriting files and skipping them in case of duplicates. The switch affects both Mac to GS 
Êand GS to Mac copies. The option key workaround found in the original 2.5 release has been
Êretired.
¥ Serial port assignments are now persistent. Bernie attempts to open a port even if it was unavailable
Êduring the last session.
¥ Improved mouse support code (compatibility with more titles)

¥ Fix: preferences button in InkMeister preview window was out of order sometimes.
¥ Fix: file types of ProDOS 8 system files are now recognized properly by Total Integration
¥ Fix: Double LoRes Graphics bug fixed
¥ Fix: ZipChipª emulation now passes proper speed to Zip utilities
¥ internal changes



New Features At A Glance

The following section describes new key features since version 2.5 very briefly. To learn more about how to use these features, please consult the manual.



ProDOS¨ CataDogª Browser


Bernie's CataDogª is a disk image browser that lists all the files on a disk, disk image or shared volume. It works with all ProDOS-formatted disks.

To catadog a particular disk, highlight it in the "Disks" window. (To bring up the Disks window, open the Window menu and choose "Disks".) Then select a disk image by clicking once on its drive icon.

Next, open the Window menu again and pick "Catalog". A new window will open listing all root files and directories on that image. Directories have an "arrow" to the left which works just like the ones found in Mac Finder windows. To expand a directory, click on its name or arrow once. To collapse a directory, click it again.

If you would like to expand an entire subtree, that is, all folders, subfolders, subsubfolders, subsubsubfolders and even more folders within, option-click a directory to see its entire content.

Browsing By File Type

CataDogª comes with a very intuitive file type feature that allows you to only display files of a particular file type. This is identical to the ProDOS CATALOG,Txxx command where "xxx" stands for a three-letter file type abbreviation. Bernie understands all official abbreviations as of 1991 specifications.

To activate the file type filter, click the area in the status bar that initially reads "ALL". "ALL" means that CataDog is showing all files. When you click the ALL button, it becomes highlighted and turns into three dots. Enter three characters to set the type filter. If a file type is not understood, Bernie barks and the type is cleared. Try again.
It is also possible to enter a hexadecimal code if you don't know a three-character abbreviation or there's no such for a particular type. (There are a number of types that only go by its hex code.) To enter a hex code, enter a dollar sign plus the hexadecimal number (for example $E8).

If you'd like to deactivate file type filtering again, click the button again and it will turn back into ALL.



Bernie Total Integration


Bernie Total Integration (BTI) is a new technology that simplifies the daunting task of sharing information between the Apple IIgs and Mac layers. BTI allows you to:

¥ drag&drop files and folders from the Mac into a GS/OS disk
¥ drag&drop files and folders from a GS/OS disk into a Mac disk
¥ paste the Mac clipboard into IIgs desktop applications
¥ paste the clipboard of IIgs desktop applications into Mac applications

BTI consists of two code modules. One half of BTI is built into Bernie while the remaining code is embedded into a GS/OS system extension. In other words, BTI is not immediately available in every GS/OS setup. Instead you do need to install the BTI system extension in the system folder in order to take advantage of it.
The BTI system extension is not compatible with earlier versions of Bernie. If BTI has been installed properly, Bernie will show a message "Bernie Total Integration ready" when starting from a BTI-enhanced system disk. The system disk does not apply any permanent patches.



Creating Cross-Platform Aliases

You can make links to both applications and documents belonging to an application. This feature is only available with Bernie Total Integration installed. 
To create an alias, highlight the file in the Apple IIgs Finder and choose "Create Alias..." from the Extras menu. You will be prompted with a save dialog.
To start the application, double-click the alias on the Mac desktop. Due to technical limitations in the Apple IIgs Finder, activating an alias of a document will first open its directory window in the Finder before it is actually launched.There's no possibility for us to avoid this extra step.

Bernie's aliases do not offer the flexibility you know from its Macintosh counterparts. If you change the name of a disk, directory or the file itself, the alias will no longer work.

Aliases are handled when the Apple IIgs Finder is the active application. If another application is running or the Apple IIgs is in the process of starting up, the alias is queued and processed as soon as the Apple IIgs Finder is ready. This also allows you to launch Bernie with an alias file to boot directly into your favorite application.

IMPORTANT: Cross-platform aliases are only available with Bernie Total Integration 1.2. You need to reinstall the Bernie.Enabler extension with the one supplied with this distribution if you'd like to use the alias feature.


Exchanging Clipboards

Bernie extends the standard File menu of Apple IIgs desktop applications with a hotkey, the option key. When holding down the option key and choosing Copy or Paste, Bernie will...

¥ copy the selected text to the IIgs clipboard and to the Mac clipboard or
¥ paste the Mac clipboard

BTI does only support ASCII text at this time. You can't copy&paste pictures or styled text.

BTI interfaces with standard toolbox commands and therefore only works with applications that rely on them. Applications that implement their own clipboard do not work with BTI.


File Drag & Drop

A true time saver is Bernie's new capability of copying files directly between GS/OS and the Mac. To copy files you must be running the Apple IIgs System 6.0 or 6.0.1 (recommended).


Copying Files From The Mac to The Apple IIgs

It only takes a couple of mouse clicks:

¥ in the Apple IIgs Finder, open the Finder window with the destination directory
¥ on the Mac, select the files you'd like to copy, drag them onto the IIgs Finder window and drop them

Bernie will then copy all files. If the selection included directories, Bernie will copy all files within that directory as well. This operation may take some time. You can't work with Bernie while the copy operation is still in progress.

BTI also allows for file copies when the Finder is not the current application, or when the Finder is running but you did not open a directory window. In that case Bernie is putting all files inside the folder...

:StartupDisk:Bernie.Transfer:

Please keep in mind that BTI is a GS/OS thing and not available in ProDOS or DOS 3.3 applications.


Copying Files From The Apple IIgs To The Mac

Copying files to the Mac is not as straightforward as the other way around, but you won't need a Ph.D. either. The basic idea is that Bernie will watch out for a special folder titled "Bernie.Transfer". (This is the same folder we talked about before.) Whenever you copy a file into that folder, it will be copied to a Mac disk instead. You can create an abundant amount of these transfer folders as the absolute path does not matter. You might even want to create one on the Finder desktop. Bernie creates a transfer folder in the startup disk's root folder on its own - this is the preferred location.
To copy files, follow these steps:

¥ open the Bernie preferences and go to the Storage section. Specify a download location
  in the Total Integration group.

¥ in the Apple IIgs Finder, make a "Bernie.Transfer" folder visible for a later drag&drop
¥ select the files you'd like to copy to the Mac
¥ drag them onto the Bernie.Transfer folder and drop them



Sound Emulation

As noted before there are internal changes concerning sound emulation. The volume control is now based on a non-linear model and delivers constant volume across all Ensoniq loads. Since volume calculation is largely based on probabilities and bandwith usage of the individual waves, the current settings reflect what we found the best setup. If you are experiencing difficulties, please drop us a line.
As with earlier versions, the volume settings "Louder" and "Did I say loud?" are very likely to produce scratches because of their excessive amplitude scaling. The clipping is part of the process and you should only use these volume settings when using software that is playing in the lower decibels.
The volume control now has a much finer resolution.




Woof!

1/13/00,hg
________________________________________________________________________


F.E.Systems Emulation Technologies
http://www.magnet.ch/emutech

Bernie home page: http://www.magnet.ch/emutech/Bernie
Download: http://www.magnet.ch/emutech/Download
Support: http://www.magnet.ch/emutech/SupportCenter
Feedback: http://www.magnet.ch/emutech/Feedback
Mailing List: http://www.magnet.ch/emutech/Bernie/List


License Agreement

Bernie ][ The Rescue is a trademark of F.E.Systems Horstmann & Gudat  ("F.E.Systems hereafter".) The software is distributed as is without warranties as to performance or fitness to a particular purpose. The user, and not F.E.Systems, assumes the entire risk for loss of data, servicing, repair , incidental and consequential damages. The Bernie ][ The Rescue archive may not be included on CD-ROMs and other high-capacity media (>2Mb) without prior written permission from F.E.Systems. Electronic distribution only with prior written permission from F.E.Systems. 

Software and documentation © 1996-2000 F.E.Systems. Diversi-Tune is a trademark of Diversified Software Research. AppleWorks, Apple, Macintosh, MacOS, Apple IIgs, ProDOS, DOS 3.3 are trademarks of Apple Computer, Inc. InkDirect, CerealPuffs, MuesliPump, ViagRAM, Sweet16, CataDog, Bernie ][ The Rescue are trademarks of F.E.Systems Emulation Technologies Horstmann & Gudat.